home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / sslog.arc / SSLOG.DOC < prev    next >
INI File  |  1987-12-13  |  5KB  |  119 lines
  1. [See bug report at end of this file.]
  2.  
  3. This "ARC" file contains the Microsoft BASIC (tm) source code for 
  4. the ARRL Sweepstakes log editing program listed in the "Contests" 
  5. chapter of The ARRL Operating Manual, Third Edition.  The program 
  6. takes an ASCII log listing (as created by you with your favorite 
  7. word processor), and produces a log package suitable for 
  8. submission to the contest sponsor.  Three separate files are 
  9. produced:
  10.  
  11.     1. A LOG file - (identified by the filename extension 
  12.        ".LOG").  This file holds the actual log.  New multipliers 
  13.        are identified and counted, and duplicate contacts 
  14.        identified.
  15.  
  16.     2. A DUPE SHEET file - (identified by the filename extension 
  17.        ".DUP").  This file holds a dupe sheet as required by the 
  18.        contest sponsors.  This is a complete listing of all the 
  19.        contacts made in alphabetical order.
  20.  
  21.     3. A SUMMARY file - (identified by the filename extension 
  22.        ".SUM").  This file holds a summary sheet for the mode
  23.        edited.  Total valid QSOs, duplicate QSOs, total QSO 
  24.        points, and multipliers worked are listed as well as a 
  25.        complete breakdown of QSOs per multiplier.
  26.        
  27. In addition to the program listing, I've also included a compiled 
  28. executable version of the program.  The executable version (same 
  29. program name but with the suffix '.EXE') runs 10 to 20 times 
  30. faster than the usual interpreted version, so you'll probably 
  31. prefer to use it rather the .BAS version.  The executable program 
  32. is set up to run on any computer even vaguely compatible with the 
  33. IBM-PC.  If you are able to read this message, your computer is 
  34. probably up to the task.
  35.  
  36. The file containing the log entries must be an ASCII file in the 
  37. following format:
  38.  
  39. <*Band> <+Time ON -Time OFF> <Time> Rcv'd Nr  Prec Call Check Sec
  40.  
  41. Any time a band change is made, the first field in the log entry 
  42. should be an asterisk, followed by the band.
  43.  
  44.    for example:    *14  would indicate a band change to 14 MHz.
  45.  
  46. To indicate on and off times, enter the time of going on or off, 
  47. preceded immediately by a plus <+> to indicate ON or a minus <-> 
  48. to indicate OFF. (MUST be 4 digits)
  49.  
  50.    for example:    +0134  would indicate an on time of 0134
  51.  
  52. Only a changed digit in the time field must be present; for 
  53. example, if the contest begins at 1800Z and the first contact is 
  54. made at 1802Z and the second contact is made at 1805Z, then only 
  55. 5 need be entered in the time field. If the third contact is made  at 1812Z, then 12 should be entered in the time field. If the 
  56. next contact is made at 1812Z, then no number need be entered in 
  57. the time field (however, be sure to enter a space to indicate 
  58. separation between fields).
  59.  
  60.  
  61.           A short set of log entries might be:
  62.  
  63.           *14 +0100  0104   434 B WB1AVA 78 CT
  64.                         5   2   A K1JX   68 CT
  65.           *21           9   99  A WA1NEV 73 CT
  66.                             765 B W3ZZ   52 MDC
  67.               -0123    14   948 B W1VD   70 CT
  68.  
  69. This log extract shows an operating period beginning at 0100 on 
  70. the 14 MHz band. A band change to 21 MHz was made at 0109, and 
  71. the period ended at 0123.
  72.  
  73. To run the compiled program, simply type the program name at the 
  74. screen prompt.  For example, type SSLOG at the A> prompt.
  75.  
  76. The three output files (.LOG, .DUP, and .SUM files) can be 
  77. printed by using the MS-DOS print command.
  78.  
  79. Some reminders:
  80.  
  81. 1. Be sure your log is in an ASCII format.  Just about every word 
  82.    processor can operate in an ASCII or Non-Document mode - that    
  83.    should work fine.  As an alternative, you can use one of the 
  84.    many utilities available in the marketplace and in the public 
  85.    domain to convert your word processor output into an ASCII 
  86.    format.  
  87.  
  88. 2. If you want the callsigns in your log to appear in capital 
  89.    letters, be sure to type them in with caps on.
  90.  
  91. 3. To avoid any deletion of valid files, use unique names for the 
  92.    files used on each mode, and don't use the extensions .LOG, 
  93.    .DUP, or .SUM.
  94.  
  95. Although this program was tested on a variety of computers and 
  96. peripheral combinations, there are undoubtedly systems that may 
  97. balk at something in this program.  If you do encounter problems 
  98. with your system, please let me know; I may not be able to help, 
  99. but perhaps I can ask someone who can give assistance.  Of 
  100. course, if you find any bugs or have any suggestions for 
  101. improvements to this program, please let me hear about these, 
  102. too.
  103.  
  104.  
  105. 73,
  106.  
  107. Clarke Greene  K1JX
  108. Compuserve ID 73016.25
  109.  
  110. Bug Report:
  111.  
  112. 1.  In SSLOG, both the West Indies and Wisconsin were abbreviated
  113.     as "WI".  The correct abbreviation for West Indies is of course
  114.     "WIN".  This has been corrected.  (Tnx WA2WIP)
  115.  
  116. 2.  In line 60 of the source file, a comment is made that each 
  117.     band requires a separate log entry file.  That should read
  118.     "(each mode requires a separate log entry file)."
  119.